home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / msdos / ddir94b.zip / DDIR94B.DOC < prev    next >
Text File  |  1993-11-30  |  15KB  |  341 lines
  1.   
  2.                                                  
  3.                                       DDIR       ▌
  4.                                                  ▌
  5.                                    Version 9.4b  ▌
  6.                                                  ▌
  7.                                  ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▌
  8.  
  9.      Note: this package contains the following files, zipped with PKZIP 2.04g:
  10.  
  11.                      DDIR.EXE
  12.                      DD94BCFG.COM
  13.                      DDIR94B.DOC
  14.                      UPGRADE.NOT
  15.                      FILE_ID.DIZ
  16.                      DISTRIB.DOC
  17.                    
  18.  
  19.  
  20. DDIR
  21.  
  22. Purpose: gives a forward/backward scrollable double-column directory display.
  23.          Protected files are flagged with a "+", system files with a "$",
  24.          hidden files with a "*".  Files created today are shown in a
  25.          different color.  Toggles d, t, w and x allow rapid on-screen display
  26.          of file size as reported by DOS, the total space required to store
  27.          the file, the dead space "wasted" by the file, and the file "storage 
  28.          efficiency"  which is simply the ratio of file size to space actually
  29.          required for storing the file. (Depending on your DOS version and/or
  30.          hard drive type, a certain minimum amount of space is required for all
  31.          files.  For example, a 10 byte batch file may actually use 32kb of
  32.          your network drive! The dead space is the amount of disk space wasted
  33.          by a file.)
  34.  
  35.          DDIR allows to mark files for deletion, and delete them and re-list.
  36.          You can view files using the author's VIEW utility and Vernon Buerg's
  37.          LIST utility.  You can also change directories from within the file
  38.          list and exit either to the starting drive/directory or to the
  39.          currently displayed drive/directory.
  40.  
  41.          DDIR reports as a summary total file size, total space actually
  42.          for the file(s) specified. TAKE A LOOK AT THE STORAGE
  43.          EFFICIENCY FOR THOSE SMALL BATCH FILES!!
  44.  
  45.          DDIR allows you to sort directory listings alphabetically,
  46.          by size, extension, age, attribute or storage efficiency, and to    
  47.          instantly (well, almost!) resort or reverse the sort order.
  48.          For lists that require more than one screen, you can also scroll
  49.          back and forth.
  50.  
  51.          You can toggle write-protect on and off for files (i.e. make them
  52.          read-only or read-and-write).
  53.  
  54.          You can copy files from the current list to another location.
  55.  
  56.          Please note that DDIR reports the count of files and
  57.          subdirectories separately, unlike the DOS dir command.
  58.  
  59.  USAGE
  60.  
  61.  Notes:   Use the same way as the DOS dir command.  Wild-card characters are
  62.           allowed.
  63.  
  64. Usage:    ddir [d:][path][file.ext]
  65.  
  66. Examples: directory of current drive and directory     ddir
  67.           list of .COM files on drive a -              ddir a:*.com
  68.           list of files of directory "one', drive c -  ddir c:\one
  69.  
  70.  
  71. Keys:
  72.  
  73.  F1  - help screen
  74.  
  75.  Esc - exit to home drive and directory
  76.  q   - exit to currently displayed drive and directory. 
  77.  
  78.  t   - mark/unmark files for deletion
  79.  Del - delete any marked files and re-list.
  80.  
  81.  Tab - change bottom display (file count summary or quick help)
  82.  
  83.  a   - sort by file attribute (system, hidden, directory etc.)
  84.  b   - back up highlighted file
  85.  c   - toggle upper/lower case display
  86.  d   - sort by file date
  87.  e   - sort by extension
  88.  f   - sort by file "storage efficiency" 
  89.  g   - view graphics file with viewer VPIC
  90.  l   - view highlighted file with LIST (by Vernon Buerg)
  91.  n   - sort by file name
  92.  p   - print directory listing
  93.  r   - reverse sort order
  94.  s   - sort by size
  95.  v   - view highlighted file with VIEW (for WordPerfect 5.0-6.0,
  96.        DOS Word 4-5.5, WinWord 1-2, Win Write, Ami Pro, ASCII)
  97.  w   - show file "wasted space"
  98.  x   - show file total space
  99.  y   - show DOS file size, wasted space and individual storage efficiency
  100.  z   - show file size reported by DOS
  101.  
  102.  +   - toggle file protect/unprotect (i.e. read-only or read and write)
  103.  
  104.  u   - interface to user-defined batch file DDIRCUST.BAT.  When you press u
  105.        the directory listing is copied to a file called DDIRUSER.FIL. You can
  106.        process this file via DDIRUSER.BAT.  The recommended use is to print
  107.        the directory list in two columns using Tony Caine's 2COL or JETCOL
  108.        programs.  For example, to use JETCOL the DDIRCUST.BAT might look like:
  109.  
  110.               c:\jetcol\jetcol ddiruser.fil
  111.  
  112.        When processing is completed the DDIR display is restored and
  113.        DDIRUSER.FIL is deleted.
  114.  
  115.  Up arrow   - scroll up one file
  116.  Down arrow - scroll down one file
  117.  PgDn       - next screen
  118.  PgUp       - previous screen
  119.  Home       - go to beginning of list
  120.  End        - go to end of list
  121.  
  122.  Right arrow - move down current screen list to select "active" file
  123.  Left arrow  - move up current screen list to select "active" file
  124.  Enter       - change to highlighted directory
  125.  
  126.  Notes: To use v or l you must have the VIEW or LIST utilities in a directory
  127.         referenced in your AUTOEXEC.BAT PATH statement).
  128.  
  129.         To use g you must have a graphics file viewer called VPIC in your
  130.         path. If you use a different viewer, you should make a copy of
  131.         the executable file and call it vpic.exe (or vpic.com if it is
  132.         a COM file).
  133.  
  134.         When you press the right or left arrow keys, the up and down arrow
  135.         keys are disabled. To re-enable, press Spacebar, PgUp, PgDn, Home
  136.         or End
  137.  
  138.  
  139.       **** IMPORTANT UPDATE NOTE ******** IMPORTANT UPDATE NOTE ****
  140.  
  141.       DDIR is an EXE file.  If you are upgrading from an earlier COM
  142.       version, be sure to delete DDIR.COM.
  143.    
  144.       **** IMPORTANT UPDATE NOTE ******** IMPORTANT UPDATE NOTE ****
  145.  
  146. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  147.  
  148.  
  149. CUSTOMIZING DDIR WITH DD94BCFG.COM
  150.  
  151. Usage: dd94bcfg [filename]
  152.                where filename is ddir.exe or a copy of ddir.exe
  153.                given some other .exe name (e.g. dd94b.exe) 
  154.  
  155. If you omit the filename, dd94bcfg will assume you want to configure
  156. ddir.exe.
  157.  
  158.  
  159. What can you configure? (quick summary)
  160.  
  161. - the display color for the file list (old files)
  162. - the display color for new files
  163. - the display color for files marked for deletion
  164. - the display color for scrolling through the file list
  165. - the date and time format (date: US, UK or International; date: 12 or
  166.   24 hour clock)
  167. - the way in which DDIR sorts the file list when you first run it
  168. - the display speed (normal e.g. for CGA, 8088; fast e.g. for EGA/VGA, 
  169.   80286 or better)
  170. - whether or not DDIR automatically detects the number of display lines
  171.  
  172.  
  173. NOTE: the customization now allows you to save your settings to a file
  174. DDIR9CFG.SAV.  You can have different versions of this file in different
  175. directories if you wish; DDIR will use the settings it finds in the directory
  176. it is run from, if a SAV file exists there.  otherwise it will use its
  177. customized default settings.  You can also reconfigure the default
  178. customization for DDIR from any SAV file you have previously created.  This
  179. feature will be maintained, if possible, in any future upgrades of DDIR,
  180. so that you will be able to reconfigure future versions automatically using
  181. the preferences you have established now.
  182.  
  183. The display colors, the date and time format and the default display (upper
  184. or lower case) can be set automatically using the accompanying configuration
  185. program DD94BCFG.BEFORE CUSTOMIZING, MAKE SURE YOU HAVE BACKED UP THE ORIGINAL
  186. DDIR.EXE TO A SAFE PLACE!  Then from the directory where you have ddir.exe
  187. simply type   dd94bcfg or dd94bcfg ddir.exe (where ddir.exe can be replaced
  188. with a copy of ddir.exe renamed to some other executable e.g. dd94b.exe). 
  189. Follow instructions.  If you choose to reconfigure ddir.exe (or the copy)
  190. directly, a modified file called DDIR94BN.EXE, using your selected
  191. customizations, will be created.  Test this before using the DOS COPY
  192. command to copy it to ddir.exe.
  193.  
  194. You can also just create a new DDIR9CFG.SAV configuration file, or reconfigure
  195. ddir.exe from an existing DDIR9CFG.SAV file (including those created from 
  196. earlier versions).
  197.  
  198. If you choose to modify the executable, rather than just create a new
  199. configuration file, DD94BCFG will try to open the file you specify on the
  200. command line, or, if none is given, will try to open DDIR.EXE.
  201.  
  202. The first set of customizations are for the display colors. You can then set
  203. the mode of date display (e.g. dd.mm.yy, mm-dd-yy etc.) and the default sort
  204. method when DDIR is run.
  205.  
  206. DDIR can, if your display adapter is appropriate, use fast screen display.
  207. Unless you are using a CGA adapter or VGA in a slow computer, you should
  208. be able to use this mode.  However, because some adapters are non-standard
  209. it is possible that running in fast display mode would lock your system. 
  210. DDIR therefore ships with the default normal display speed.  You can modify
  211. this through DD94BCFG.  If doing so causes no problems stay with it; if a
  212. problem does arise, re-run DD94BCFG and select normal display speed.
  213.  
  214. Some non-standard BIOSes do not correctly return the number of lines being
  215. used on the display screen (25 on CGA; up to 60 on VGA displays).  Although
  216. DDIR tries to detect abnormal results, you can, as an added precaution, force
  217. it to use only 25 lines.  Normally,  select "let DDIR choose", and force it
  218. to 25 lines only if there is a problem with the display.  IMPORTANT: If you
  219. have selected "normal display speed" DDIR will run in 25 line mode ONLY.
  220.  
  221.                              *** IMPORTANT ***
  222.  
  223. The author makes no warranty that the software in this package
  224. will work with your particular hardware configuration.  You use the
  225. programs entirely at your own risk, and the author will not be held
  226. liable for any damage caused to your hardware or software through
  227. use of this software, or for any other effects, direct or indirect,
  228. of using the software.
  229.  
  230. Legalities aside, you should not run into difficulties with this
  231. software.
  232.  
  233.  
  234.                           **** SHAREWARE ****
  235.  
  236.  
  237. These programs are distributed as shareware, AND ARE NOT CRIPPLED!!.
  238. (Editorial note: I don't support "crippleware" - I want to know
  239. EXACTLY what I'm expected to pay for! Crippleware is, in my opinion,
  240. like test driving a Mercedes that's been fitted with a two-stroke engine!
  241. There, that's said - but each to his own.)
  242.  
  243. You do not have to register as a user, nor are you under any
  244. obligation to buy the program(s).  However, they are not free, and in
  245. the spirit of shareware, you are requested to make a small
  246. donation to the author if you find the software in this package useful,
  247. and if you continue to use it after an evaluation period of 30 days. This
  248. would both fulfil your moral obligation and help ensure the viability of
  249. the shareware concept, from which we all benefit. If you choose not to pay,
  250. you are asked to remove the program files from your computer.
  251.  
  252. The suggested contribution is $15 but less (or more!) would be fine. Pay what
  253. you think the software is worth to you. If you pay the recommended amount PLUS
  254. ADD $4 for shipping and handling, I will send you a 5 1/4" diskette with the
  255. latest version plus a selection of other shareware (my own and the best from
  256. other authors, including 2COL/JETCOL by Tony Caine). Alternatively, send a
  257. blank diskette of your preferred size (5 1/4" 360kb or 1.2Mb, or 3 1/2" 720kb
  258. or 1.4 Mb) plus $3 s&h.
  259.  
  260. Should you decide to make a contribution, please remit to:
  261.  
  262.                    Malcolm Drury
  263.                    11 Adele Crescent
  264.                    Nepean
  265.                    ON  K2J 2T7
  266.                    Canada
  267.  
  268. Internet drury@gsc.emr.ca
  269. Compuserve 70574,3457
  270.  
  271. Bank notes would be fine!  Thank you. Please tell me where you
  272. got the software from (this helps me in knowing where to post updates), and,
  273. most importantly, which version it is.
  274.  
  275.  
  276. IF YOU HAVE PREVIOUSLY PAID FOR AN EARLIER VERSION  -  THANKS, AND
  277. OF COURSE YOU ARE NOT EXPECTED TO PAY AGAIN. YOUR INPUT, COMMENTS
  278. ETC. ARE ALWAYS WELCOME.
  279.  
  280. Please note that at the low contribution requested, I cannot provide direct
  281. technical support, nor automatically send upgrades, should they
  282. become available. If you have comments, questions, bug reports etc., please
  283. leave a message at my Compuserve or INTERNET address, or write to me via
  284. snail mail. I will endeavor to fix any problems you might encounter.
  285.  
  286. The software is supplied on an "as is" basis. You are free to distribute
  287. this software package provided that you distribute the ENTIRE package,
  288. including this documentation file. (This is necessary for others to be able
  289. to use it properly.  I've downloaded too many shareware packages that had
  290. been posted without accompanying documentation!).
  291.  
  292. I hope you find this package useful.
  293.  
  294.  
  295. Malcolm Drury
  296. October 20th, 1993
  297.  
  298.  
  299. HOW TO OBTAIN VIEW
  300.  
  301. VIEW is available on many BBS and on Compuserve/Ziffnet (VWFILE.ZIP
  302. in ZNT:TIPS).  If you wish to obtain a copy directly from me, please add $15
  303. to your contribution. Alternatively, get it from your BBS and "try before you
  304. buy" just as you are doing with DDIR.  From your favorite BBS just do a search
  305. on "VIEW??.*"  As of this date the current version is 8.61.
  306.  
  307. ********************************************************************************
  308.  
  309.             Look for the following shareware on this BBS
  310.  
  311. VGAPAL40.ZIP - customize up to 4 VGA text color palettes, choosing from more
  312.              than 260,000 colors! (And see how many you can actually discern!).
  313.              One palette can be used to create a small (2k) TSR program that
  314.              maintains your chosen scheme.  Alternatively, you can set any of
  315.              the palettes, or a grey-scale scheme, from a non-TSR if
  316.              memory or loading a TSR is a problem. (On Compuserve/Ziffnet
  317.              in ZNT:TIPS as vgacus.zip)
  318.              BBS search: vgapal??.zip
  319.  
  320.  
  321. DSPACE63.ZIP - shows graphically hard disk space installed, used and free,
  322.                for all drives, and shows drive type (local, remote, RAM etc.);
  323.                second program shows graphically space on designated drive
  324.                (including floppy), and reports on installed and available
  325.                RAM, including XMS and EMS memory. (On Compuserve/Ziffnet
  326.                in ZNT:TIPS as dskspc.zip)
  327.                BBS search: dspace??.zip
  328.  
  329. VIEW862.ZIP  - file viewer for WordPerfect 5.0 - 6.0, ASCII, Ami Pro and
  330.                Word (DOS 4/5 and Windows 1/2); includes text search,
  331.                printing full or partial file, etc.  (On Compuserve as
  332.                VWFILE.ZIP in ZNT:TIPS).  BBS search:  view???.zip.
  333.  
  334. IF YOU DO NOT FIND ANY OF THESE, LEAVE ME A MESSAGE! I'LL BE HAPPY TO SEND
  335. THEM TO YOU, BUT IN THE INTERESTS OF CUTTING DOWN CONNECT TIME WOULD
  336. PREFER TO USE INTERNET. THAT WOULD REQUIRE YOU TO HAVE THE UUDECODE.EXE
  337. PROGRAM, WHICH SHOULD BE AVAILABLE ON ANY BBS YOU USE.
  338.  
  339. CIS 70574,3457
  340. INTERNET drury@gsc.emr.ca
  341.